home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Code Resources / Jims CDEFs 1.50 / ReadME first!! < prev    next >
Encoding:
Text File  |  1995-11-13  |  4.3 KB  |  123 lines  |  [TEXT/ttxt]
  1. Read ME first!!
  2. -------------------------------------------------------------------------
  3. Ok, what is this stuff?
  4.  
  5. Years ago, I was a mainframe programmer - got tired of Cobol and switched to
  6. database & 4th generation languages.  After I tired of that, I started
  7. programming on the Mac.  I had to teach myself both the Macintosh Toolbox and
  8. "C" at the same time.  One of my primary sources for programming instruction
  9. was other people's code - I constantly cruised the forums on CompuServe and
  10. Genie and downloaded anything that said "source" in the description.
  11.  
  12. This is a small gift in return.  Hopefully, someone, somewhere will learn
  13. something from this collection of odds and ends.
  14.  
  15. If you find this stuff useful, have questions, find bugs or have enhancement
  16. ideas, drop me a note via email. I will probably continue to enhance this
  17. package, so I plan on keeping a list of people to notify when I post a new 
  18. release.
  19.  
  20. Please read the "Conditions for use…" document for information about using
  21. these CDEFs or source code for the CDEFs.
  22.  
  23. Jim Stout
  24. November 1995
  25.  
  26. I can be reached electronically at:
  27.  
  28. Internet    : JimS@WRQ.COM    (work hours, PST)
  29. CompuServe  : 73240,2052    (weekly or so)
  30. AOL         : JasG            (weekly or so)
  31. eWorld      : Jim Stout        (weekly or so)
  32. -------------------------------------------------------------------------
  33.  
  34. The CDEFs and source code are Copyright ©1991-1995 James G. Stout
  35.  
  36. Use of the CDEFs and source code is detailed in the accompanying "Conditions for
  37. use" document.
  38.  
  39. The utility code in this package may be incorporated in any freeware, shareware, 
  40. commercial or other software package, without restrictions.
  41.  
  42. ------------------------------------------------------------------------------
  43. Accompanying this note, you should find:
  44.  
  45. 1. A collection of code resources.  Just paste them into the .rsrc files
  46. for your programming projects and use them. 
  47. (the CDEFs can be found in: "CDEF Source ƒ:resources:xDEF.rsrc")
  48.  
  49. For many details about the CDEFs, how to use them and some programming tips;
  50. read the "About CDEFs" file.
  51.  
  52. 2. The projects and 'C' source to build all of the CDEFs.  Projects for Think 7,
  53. Symantec 8.0.3, Metrowerks (CW7) and an MPW makefile are included.
  54.  
  55. 3. A demo program project to show the use of the CDEFs.
  56.  
  57. 4. A sample of source that demonstrates one way to debug a simple CDEF.  See the
  58. items with "test3D" in their name.
  59.  
  60. 5. Some utility routines to assist in writing dialog routines.
  61.    They are:
  62.     
  63.     - dialogAssist.c
  64.     - dimText.c
  65.     - movableModal.c
  66.     - panelAssist.c
  67.     - TogLib.c
  68.     
  69.     and matching header files.
  70.     
  71. Here is what the utility routines do - the code is fairly well commented, so
  72. study the code itself.
  73.  
  74. dialogAssist.c/.h
  75. -----------------
  76. I simply got tired of writing pairs of GetDItem()/SetDItem() and similar calls.
  77.  This file is a collection of routines that make one call replacements for
  78. handling controls, keys or the mouse in dialogs.
  79.  
  80. Also, there are some utility routines to do some special dialog handling - like
  81. limiting input length, numeric input, checking for command or option keys or a
  82. "exit" key (enter or escape).
  83.  
  84. There are lots of handy routines in this file, study it to see if there is
  85. anything you can use.
  86.  
  87. dimText.c/.h
  88. ------------
  89.  
  90. These routines were written by JWWalker.  They are used by some of the
  91. dialogAssist routines.
  92.  
  93. To use these routines, do the following:
  94.  
  95. 1. Create your dialog.
  96. 2. Call initDimText(yourDialogPtr) before calling ModalDialog.
  97. 3. Call daDimOne() to dim a text item (edit or static).
  98. 4. Just before calling DisposDialog(), call disposeDimText().
  99.  
  100. Note that if you use AppendDITL or ShortenDITL (as in the tab Panel demo),
  101. there are extra calls to be used.  See dialogDemo.c for an example.
  102.  
  103. movableModal.c/.h
  104. -----------------
  105. A set of routines to assist in implementing "Movable Modal" dialogs.  Simply
  106. substitute a call to "ModalDialog" with a call to "movableModalDialog".  Two
  107. cautions:
  108.  
  109. 1. Use the proper window definition in your dialog resource.
  110.  
  111. 2. There are several external routines that will be called by the movable
  112. modal routines.  See the movableModal.c file for details.
  113.  
  114. panelAssist.c/.h
  115. ----------------
  116. Two routine to help in implementing tabPanel dialogs.  See the file "About
  117. CDEFs".
  118.  
  119. TogLib.c/.h
  120. -----------
  121. Routines to assist in handling "Tog" buttons. See the file "About CDEFs".
  122.  
  123. ------------------------------------------------------------------------------